#!/bin/bash -e

export NAME=`git config user.name`
export EMAIL=`git config user.email`

# 1. 使用 source 命令载入此文件
# 
# 执行命令: source maintainer-env-setup.sh
# ~ 变量 NAME 是 dch 使用的维护者名称，你可以使用自己喜欢的名称
# ~ 变量 EMAIL 是 dch 使用的维护者邮箱，你可以使用自己喜欢的邮箱
# ~ 如以下结构
#   -- zinface <zinface@163.com>  Thu, 30 May 2024 00:00:00 +0800

# 2. 使用 dch 命令创建 debian/changelog 文件，并设置包名，版本
#
# 创建目录: mkdir debian
# 创建文件: dch --create --package <pkg> --version 0.0.1 "初始化变更日志"
# ~ 使用 --package 在创建此变更记录文件时定义软件包的名称
# ~ 使用 --empty 参数代替变更信息可创建空的版本变更，但不建议使用空信息
#

# 3. 使用 dch 命令追加、改变、编辑变更信息，及新的变更版本、类型转化等
# 
# 追加变更: dch [-a] "添加新的功能"
# ~ 使用 -a 或省略都可追加变更
#
# 编辑变更: dch -e
# ~ 使用 -e 将直接打开编辑器，可使用 select-editor 选择要使用的编辑器
#
# 类型转化: dch [--release|--lts|--stable] [--distribution ...]
# ~ 使用 --release 可以将当前版本进行转化，如一种可即将释出的版本
# ~ 使用 --distribution 可指定为具体类型：
#       experimental, unstable, testing, stable, oldstable, oldoldstable,
# ~ 不同类型之间可以进行组合, 无必要情况下，可不指定，随之默认转化为(unstable)
#       {bullseye,buster,stretch,jessie,wheezy}-proposed-updates,
#       {testing,stable,oldstable,oldoldstable}-proposed-updates,
#       {bullseye,buster,stretch,jessie,wheezy}-security,
#       {testing,stable,oldstable,oldoldstable}}-security, buster-backports, bullseye-backports and UNRELEASED.
#
# 新的版本: dch --version 0.0.2 "版本提升，新功能变化"
# ~ 使用 --version 可创建新的版本，并且通过直接添加消息，可以跳过使用编辑器
# ~ 在使用前，如果上一个版本没有进行类型转换，将会改变当前 UNRELEASED 状态的版本而不会创建新的版本
# 

# 使用过程
# 1. 创建目录、初始化 changelog 文件
# 2. 追加变更、类型转化
# 3. 新的版本、追加变更、类型转化 
# 4. 重复第3步